home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / mbu_110.zip / MBUTIL.DOC < prev    next >
Text File  |  1990-05-26  |  37KB  |  975 lines
  1.  
  2.  
  3.      MBUTIL - RemoteAccess/QuickBBS Message Base Utility 1.10
  4.      Copyright (C) 1990 Gerard van der Land. All rights reserved.
  5.  
  6.  
  7.  
  8.      Features
  9.      --------
  10.  
  11.      * Sorting messages by board and post date and time
  12.      * Purging messages by number, date or received status
  13.      * Message base packing with AutoRenumber
  14.      * Reply chain linking and subject cleaning
  15.      * Creating index files and fixing all kinds of problems and errors
  16.      * Undeleting deleted messages
  17.      * Moving all messages in one board to another board
  18.      * Posting a file as a message
  19.      * Netmail Import .MSG ==> MSG*.BBS
  20.      * Netmail Export MSG*.BBS ==> .MSG (updates credit)
  21.      * Replacing up to 5 different tearlines in outgoing echomail messages
  22.      * Creating 'Outbound Traffic Report'
  23.      * Build-in help screens for all commands
  24.      * It  does  NOT require  a  specific  BBS program,  mailer  or message
  25.        editor, as it uses its own control file and environment variable
  26.      * Writes logfile in  FrontDoor, Opus,  D'Bridge, Binkley and  QuickBBS
  27.        format
  28.  
  29.  
  30.  
  31.      Disclaimer, License and Other Important Stuff
  32.      ---------------------------------------------
  33.  
  34.            The following points  must be considered, understood  and agreed
  35.      upon BEFORE you use MBUTIL 1.10:
  36.  
  37.      * MBUTIL is distributed  as ShareWare, and  not as FreeWare or  Public
  38.        Domain!
  39.  
  40.      * This  documentation  and  the accompanying  program  is  copyrighted
  41.        material by Gerard van der Land.
  42.  
  43.      * Although care  has been taken to write and  test a program that does
  44.        what this documentation  states, the program  is provided as it  is,
  45.        without  warranty or  guarantee  of any  kind,  either expressed  or
  46.        implied, as to  the quality or  performance of this program,  except
  47.        that it will occupy disk space.
  48.  
  49.      * The author will not be held liable to you or anyone for  any direct,
  50.        indirect, incidental  or consequential  damages, including any  lost
  51.        profits, lost savings which may result  from the use or inability to
  52.        use this program.
  53.        Your  use  of   the  program  constitutes  your  agreement  to  this
  54.        disclaimer and your release of the author from any form of liability
  55.        or litigation.
  56.  
  57.      * You  are granted  limited license  to use  MBUTIL 1.10  and you  are
  58.        encouraged to copy and distribute it in an unmodified way as much as
  59.        you want, as  long as you  still abide to  the conditions  mentioned
  60.        here and no money or other compensation is asked or accepted.
  61.  
  62.                                         1
  63.  
  64.      System Hardware and Software Requirements
  65.      -----------------------------------------
  66.  
  67.      * An IBM PC, XT, AT or 100% compatible.
  68.      * The amount  of RAM  that should  be available  very much  depends on
  69.        which command you  are using and how  big your message base  is, but
  70.        around 300 KB should  be enough in most  cases. If you run  it under
  71.        DoubleDOS/DesqView,  just   try.  If   there's  not   enough  memory
  72.        available, MBUTIL will certainly let you know!
  73.      * Microsoft  MS-DOS  3.00  / IBM  PC-DOS  3.00  or  above. MBUTIL  was
  74.        successfully tested under MS-DOS 4.01.
  75.      * At least "FILES=15" (or more) in your CONFIG.SYS.
  76.      * A RemoteAccess ≤ 0.0x or QuickBBS 2.xx compatible message base.
  77.  
  78.  
  79.  
  80.      Setup
  81.      -----
  82.  
  83.            Before you use MBUTIL  you should enter your information  in the
  84.      control file MBUTIL.CTL using an ASCII text editor. Explanation of the
  85.      keywords is given there.
  86.  
  87.  
  88.  
  89.      Environment Variable
  90.      --------------------
  91.  
  92.      Usage:
  93.  
  94.         SET MBU=<controfile> [<color>]
  95.  
  96.            To be able to run MBUTIL from any directory, you can use the MBU
  97.      environment variable. If  MBUTIL can't find MBUTIL.CTL  in the current
  98.      path, it will try the open the filename set with MBU. This can also be
  99.      useful for people having  more than one message base, who  can use SET
  100.      to select from their batch file which control file should be used.
  101.  
  102.            <color> is optional and is the default text color, which is also
  103.      used  if  the  control file  was  found  in the  current  path.  It is
  104.      calculated as follows:
  105.  
  106.         <foreground color> + (16 * <background color>)
  107.  
  108.      Colors:
  109.  
  110.         0    Black                4    Red
  111.         1    Blue                 5    Magenta
  112.         2    Green                6    Yellow
  113.         3    Cyan                 7    White
  114.  
  115.            Add 8 for highlighted foreground colors. <color> is 7 by default
  116.      (White text on a Black background).
  117.  
  118.      Example:
  119.  
  120.         SET MBU=C:\RA\MBUTIL.CTL 3
  121.  
  122.  
  123.                                         2
  124.  
  125.      Specifying Boards
  126.      -----------------
  127.  
  128.            If you must specify a  <board>, you can use the area tag (if you
  129.      have specified an AreasFile in the control file), or #<boardnumber>.
  130.  
  131.            A special fixed area name is  "NETMAIL", which will always refer
  132.      to your NetmailBoard, if defined.
  133.  
  134.  
  135.  
  136.      Help Screens
  137.      ------------
  138.  
  139.            If you run 'MBUTIL', you will see the following help screen:
  140.  
  141.      +-------------------------------------------------------------------+
  142.      | MBUTIL - RemoteAccess/QuickBBS Message Base Utility 1.10          |
  143.      | Copyright (C) 1990 Gerard van der Land. All rights reserved.      |
  144.      |                                                                   |
  145.      | Usage:                                                            |
  146.      |                                                                   |
  147.      |    MBUTIL <command> [<parameters>]                                |
  148.      |                                                                   |
  149.      | Commands:                                                         |
  150.      |                                                                   |
  151.      |    Export      Export netmail messages and replace tearlines      |
  152.      |    Import      Import netmail messages                            |
  153.      |    Index       Create new index files                             |
  154.      |    Link        Create reply chains and clean subjects             |
  155.      |    Move        Move messages in one board to another board        |
  156.      |    Pack        Pack the message base files                        |
  157.      |    Post        Post a file as message in a specified board        |
  158.      |    Purge       Delete messages according to age or number         |
  159.      |    Sort        Sort unread or all messages by board/date/time     |
  160.      |    Undelete    Undelete deleted messages                          |
  161.      |                                                                   |
  162.      | Run 'MBUTIL <command> ?' to get information about <parameters>.   |
  163.      |                                                                   |
  164.      | C:\RA>_                                                           |
  165.      |                                                                   |
  166.      +-------------------------------------------------------------------+
  167.  
  168.      Example:
  169.  
  170.         MBUTIL Purge ?
  171.  
  172.            This will give you  information about the Purge command  and its
  173.      parameters. If a  parameter is  missing or invalid,  MBUTIL will  also
  174.      show you a help screen.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                         3
  185.  
  186.      Sort
  187.      ----
  188.  
  189.      Usage:
  190.  
  191.         MBUTIL Sort [-All] [-Backup] [-Pack]
  192.  
  193.              The Sort command can  be used to  sort all unread messages  by
  194.        board number and post date and time. This has two advantages:
  195.  
  196.           + When using combined read mode to read new messages for example,
  197.             you won't see messages from different boards mixed up.
  198.           + It reduces the chance that you read a reply to a message before
  199.             you  actually  read the  message  that  was  replied to,  which
  200.             happened pretty often to  me and which was actually  the reason
  201.             why I started  writing MBUTIL in the first place!  But from one
  202.             thing came another...
  203.  
  204.              Reading replies  before the original messages is in most cases
  205.        caused  by  echo  mail  processors that  don't  sort  incoming  mail
  206.        packets, but I think that DOESN'T HAVE TO BE the case, since a reply
  207.        can simply have a shorter or  faster PATH than the message that  was
  208.        replied to.
  209.  
  210.              MBUTIL checks if  there is enough disk  space available. After
  211.        that it scans LASTREAD.BBS to find the highest message that was read
  212.        by all users. MBUTIL assumes there are actually messages to sort and
  213.        starts  rewriting   MSGHDR.BBS  and   MSGTOIDX.BBS  while   scanning
  214.        MSGHDR.BBS to  find out where  to start sorting.  I could  have used
  215.        MSGIDX.BBS for this, but the current way is more reliable and  works
  216.        faster  if  there actually  are messages  to  sort, which  will most
  217.        likely be  the case if you run Sort only each time new messages were
  218.        tossed in to the message base.
  219.  
  220.              MBUTIL will  remove  all reply  chains while  sorting, so  you
  221.        should run 'MBUTIL Link'  each time you used Sort.  The next version
  222.        might Link  while Sorting.  This version can  sort up to  about 9360
  223.        messages.
  224.  
  225.              You  can use '-All' to sort  the entire message base, but THIS
  226.        IS NOT  RECOMMENDED  FOR BBS  SYSTEMS,  as IT  DOES  NOT UPDATE  THE
  227.        LASTREAD.BBS POINTERS (I  suggest you delete LASTREAD.BBS if you use
  228.        this switch). It was only added because some POINTS in the beta-team
  229.        requested it.
  230.  
  231.      Switches:
  232.  
  233.         -All       Sort entire message base (ignores LASTREAD pointers)
  234.         -Backup    Keep the original MSGHDR.BBS as backup (.BAK)
  235.         -Pack      Remove header records of deleted messages
  236.  
  237.  
  238.  
  239.  
  240.              The rest of MBUTIL  is actually a clone of  TosScan(q) Message
  241.        Utility (TSUTIL) 1.00, with some additions and improvements here and
  242.        there. TSUTIL was written by Mats Wallin and Joaquim Homrighausen. I
  243.        hope they won't be angry with me! ;-)
  244.  
  245.                                         4
  246.  
  247.      Purge
  248.      -----
  249.  
  250.      Usage:
  251.  
  252.         MBUTIL Purge [-File <file>] [<criteria>] [-Convert <output>]
  253.  
  254.              The Purge  command can  be used  to delete  messages based  on
  255.        <criteria> specified per board, like age, received status or maximum
  256.        number  of messages.  <criteria> can  be a  command line  or  a text
  257.        <file> with lines in the following format:
  258.  
  259.        [<board>] [-All] [-Days <days>] [-Rcvd] [-Msgs <number>]
  260.  
  261.               <file> can also  be "RemoteAccess"  or "TosScan", which  will
  262.        use their files, if found in the current path.
  263.  
  264.              If you add '-Convert <output>', you  can convert TosScan or RA
  265.        information to a <output> text file. If you use '-Msgs <msgs>  -Days
  266.        <days> -Rcvd -Convert <output>', your AreasFile will be converted to
  267.        purge file format. You may put comments after a ; in a text <file>.
  268.  
  269.              If  you use '-File  <file> -Days <days>  -Msgs <msgs>', <days>
  270.        and  <msgs> will  apply  to  all  boards for  which  the  number  of
  271.        Days/Msgs was not defined (zero) in <file>.
  272.  
  273.              If you  use '-File <file> <board> -Days  <days> -Msgs <msgs>',
  274.        <days> and <msgs> will override the settings in <file>.
  275.  
  276.              If you use '[-File <file>] [<board>] -Rcvd', received messages
  277.        will be deleted in <board> or all boards.
  278.  
  279.              If you use '-File RemoteAccess [...]', it will delete received
  280.        messages in all boards  where the "Days After Received  Messages are
  281.        Killed" value in RACONFIG is non-zero.
  282.  
  283.              If you want to,  you can still retrieve deleted  messages with
  284.        'MBUTIL Undelete', described later.
  285.  
  286.      Switches:
  287.  
  288.         -All        Delete all messages (won't be used as default)
  289.         -Days       Delete messages older than <days>
  290.         -Rcvd       Delete all received messages
  291.         -Msgs       Delete all except the last <number> messages
  292.         -Convert    Convert AreasFile, MESSAGES.RA or AREAFILE.FD
  293.  
  294.      Examples:
  295.  
  296.      ; Delete messages  older than 2 weeks  and received messages on  board
  297.      10.
  298.      MBUTIL Purge #10 -Days 14 -Rcvd
  299.  
  300.      ; Delete messages in SYSOPS.028 according to information in MBUTIL.PUR
  301.      MBUTIL Purge -File MBUTIL.PUR SYSOPS.028
  302.  
  303.  
  304.  
  305.  
  306.                                         5
  307.  
  308.      Pack
  309.      ----
  310.  
  311.      Usage:
  312.  
  313.         MBUTIL Pack [-Backup] [-Force] [-Overwrite] [-Renumber]
  314.                     [-Delete] [-Recover]
  315.  
  316.              The Pack command can be used to pack the message base files by
  317.        removing deleted messages.
  318.  
  319.              Pack will by default rewrite the  message base file and delete
  320.        the old files  if the message  base was packed successfully.  If you
  321.        use '-Backup', it will  keep MSGHDR.BAK and MSGTXT.BAK. Note  that I
  322.        don't keep a backup of  the index files. If you should  ever need to
  323.        use your backup message base, just  run 'MBUTIL Index' to create new
  324.        index files. By using  '-Overwrite' you can choose to  overwrite the
  325.        existing files if there's not enough disk space to create new files.
  326.        I personally  always use and  recommend using '-Force'  to overwrite
  327.        the existing message base files,  which has the following advantages
  328.        and disadvantages:
  329.  
  330.           + It  requires no free  disk space at all,  which is actually the
  331.             reason why I always HAVE to use overwrite mode. :-)
  332.  
  333.           + It is much faster (especially  since MBUTIL won't rewrite  text
  334.             blocks that don't need to be moved)
  335.  
  336.           + It causes less  disk fragmentation,  and thus prevents  message
  337.             base access from slowing down.
  338.  
  339.           - It  is  a  little bit  more  dangerous,  because  if MBUTIL  is
  340.             interrupted  while  overwriting, it  will probably  damage your
  341.             message base beyond repair. 'MBUTIL Index -Delete -Renumber' is
  342.             the  best  you can  do  when  this should  happen.  MBUTIL will
  343.             temporary ignore the Ctrl-Break  and Ctrl-C keys when it  is in
  344.             overwrite-mode so you can't accidentally interrupt it.
  345.  
  346.              When MBUTIL has  renumbered the messages,  it will update  the
  347.        LASTREAD pointers in LASTREAD.BBS. If USERS.BBS exists it  will also
  348.        update the 'highest read' pointers in  the user records and reformat
  349.        LASTREAD.BBS if necessary. I recommend using  '-Renumber' regularly.
  350.        MBUTIL will automagically renumber if  the highest message number is
  351.        higher than what you defined using the 'AutoRenumber' keyword in the
  352.        control file.
  353.  
  354.        See 'MBUTIL Index' on  the next page for details  on using '-Delete'
  355.        and '-Recover'.
  356.  
  357.      Switches:
  358.  
  359.         -Backup        Keep the original MSGHDR.BBS and MSGTXT.BBS as .BAK
  360.         -Force         Force overwriting of the existing message base files
  361.         -Overwrite     Overwrite existing files only if short of disk space
  362.         -Renumber      Renumber messages and update LASTREAD pointers
  363.         -Delete        Delete messages crosslinked in MSGTXT.BBS
  364.         -Recover       Move messages in invalid boards to the RecoveryBoard
  365.  
  366.  
  367.                                         6
  368.  
  369.      Index
  370.      -----
  371.  
  372.      Usage:
  373.  
  374.         MBUTIL Index [-Delete] [-Recover] [-Renumber]
  375.  
  376.        The Index command can be used to create the following index files:
  377.  
  378.           MSGIDX.BBS     This file  contains the message and  board numbers
  379.                          of each parallel records in MSGHDR.BBS. It is used
  380.                          to quickly find a message by  message number or to
  381.                          find the previous/next message on a specific board
  382.                          or in the entire message base.
  383.  
  384.           MSGTOIDX.BBS   This file contains  the name of the  addressees of
  385.                          the messages in the parallel record in MSGHDR.BBS.
  386.                          It contains "* Received *" if a message is already
  387.                          received and "* Deleted *" if a message is already
  388.                          deleted. It is  used to  quickly check the  entire
  389.                          message base for personal mail.
  390.  
  391.           MSGINFO.BBS    This file contains the total number of messages in
  392.                          the entire  message base,  the highest  and lowest
  393.                          message  numbers used  and the number  of messages
  394.                          per  board. It is  used to  give the  BBS program,
  395.                          message  editor  or   echo  mail  processor   this
  396.                          information without having to scan MSGHDR.BBS.
  397.  
  398.              Note that  these index  files are  also created  by the  Pack,
  399.        Purge and Undelete  commands. If  Sort sorted message  it will  also
  400.        create new index files.
  401.  
  402.              You can optionally  delete crosslinked  messages (two or  more
  403.        messages  claiming  partially   or  entirely   the  same  block   in
  404.        MSGTXT.BBS) or messages  pointing to  a non-existing block  (outside
  405.        MSGTXT.BBS). You can also choose to  move messages in invalid boards
  406.        (0 or > 200) to the RecoveryBoard. If you haven't defined one, these
  407.        messages  will  be  deleted  if  you  use the  -Delete  or  -Recover
  408.        switches. Please  note that -Delete  and -Recover  don't update  the
  409.        reply chains.
  410.  
  411.              If the message numbers  really get out of order and/or Pack is
  412.        unable to renumber the messages (for  instance if there are negative
  413.        message numbers or you  don't have enough memory available)  you can
  414.        use the -Renumber  switch to fix  this. Please note  that this  will
  415.        *NOT* update the LASTREAD pointers. Only  use this switch in extreme
  416.        emergencies.  If  you don't  have very  much  memory you  should run
  417.        'MBUTIL Pack -Renumber' regularly or choose a low AutoRenumber value
  418.        to prevent needing this.
  419.  
  420.      Switches:
  421.  
  422.         -Delete        Delete messages crosslinked in MSGTXT.BBS
  423.         -Recover       Move messages in invalid boards to the RecoveryBoard
  424.         -Renumber      Renumber all message numbers in MSGHDR.BBS
  425.  
  426.  
  427.  
  428.                                         7
  429.  
  430.      Link
  431.      ----
  432.  
  433.      Usage:
  434.  
  435.         MBUTIL Link [-Clean] [-Remove]
  436.  
  437.              The Link command can  be used to  link messages with the  same
  438.        subject in a reply chain that can be walked through with the message
  439.        editor or the BBS program.
  440.  
  441.              MBUTIL  will  always create  new reply  chains for  all boards
  442.        rather than  updating any  existing reply  chains. Deleted  messages
  443.        will  not be  linked. MBUTIL  links messages using  a CRC-32  on the
  444.        message  subjects, ignoring  case and  "Re:" or  "(R)"  junk. Future
  445.        versions of MBUTIL will use the  MSGID and REPLY kludges and/or sort
  446.        the reply chains by post date.
  447.  
  448.              With the -Remove switch  MBUTIL will only remove all  existing
  449.        reply chains.
  450.  
  451.              With the -Clean switch MBUTIL will remove "Re:" and "(R)" junk
  452.        from the subject texts.
  453.  
  454.              I  recommend  running 'Link  -Clean'  each time  messages were
  455.        tossed into the message base.
  456.  
  457.      Switches:
  458.  
  459.         -Clean        Remove "Re:" and "(R)" from subjects
  460.         -Remove       Remove all existing reply chains
  461.  
  462.  
  463.  
  464.      Move
  465.      ----
  466.  
  467.      Usage:
  468.  
  469.         MBUTIL Move <from_board> <to_board>
  470.  
  471.              The Move command can be used to move all messages in one board
  472.        to another board. The messages are  not physically moved, only their
  473.        board number  is changed.  They keep  the same  message numbers  and
  474.        reply chains. Deleted messages will not be moved.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                         8
  490.  
  491.      Export
  492.      ------
  493.  
  494.      Usage:
  495.  
  496.         MBUTIL Export [-Crash] [-Direct] [-Keep] [-ReTear] [-Report]
  497.  
  498.      or:
  499.  
  500.         MBUTIL Export <board> <path> [-Delete]
  501.  
  502.              The Export command is  the opposite of the Import  command and
  503.        can be used to  export messages from RemoteAccess message  boards to
  504.        FidoNet  .MSG standard messages.  It will by  default export netmail
  505.        messages from all boards to the NetmailPath if defined.
  506.  
  507.              If netmail was entered using RemoteAccess, those programs will
  508.        increment the  Pending field  in the  user record.  When MBUTIL  has
  509.        exported such  messages, it will  decrement both Pending  and Credit
  510.        fields in the user record (if found).
  511.  
  512.              Netmail will  NOT be exported if  it is destined to  your main
  513.        address or one of your Aka's.
  514.  
  515.              When export is used  to export netmail, it will  also turn off
  516.        invalid  'Outgoing EchoMail' bits  of messages  that don't  have the
  517.        Local bit set, which  fixes the problem that Qecho  exports messages
  518.        that you replied to with FrontDoor 1.99c.  MBUTIL will also create a
  519.        file TRAFFIC.MBU, that contains the number of outbound messages from
  520.        each board. Use '-Report' to produce the report TRAFFIC.RPT.
  521.  
  522.              When you use  the -ReTear switch, MBUTIL will  search outgoing
  523.        echomail messages  for up  to five  specified tearlines and  replace
  524.        them with the matching ones, comparable to ReTear by Cary Howell.
  525.  
  526.              If you specify  <path> <board>, you  can use MBUTIL to  Export
  527.        all messages in an RemoteAccess board to .MSG format. Don't use this
  528.        to export netmail!
  529.  
  530.      Switches:
  531.  
  532.         -All       Send all messages to another zone direct, not via the
  533.                    zonegate (myzone:myzone/destzone)
  534.         -Crash     Send only crash messages to another zone direct
  535.         -Keep      Keep the message in the NetmailPath after they have been
  536.                    sent. Normally to are killed after they have been sent.
  537.         -Delete    Delete messages in the RemoteAccess board after they
  538.                    have been exported. This is always done for netmail
  539.                    with the Kill/Sent bit set, even if you use -Keep.
  540.         -ReTear    Replace the tearlines of Outgoing Echomail messages
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                         9
  551.  
  552.      Import
  553.      ------
  554.  
  555.      Usage:
  556.  
  557.         MBUTIL Import [-Users]
  558.  
  559.      or:
  560.  
  561.         MBUTIL Import <path> <board> [-Delete]
  562.  
  563.              The Import command is  the opposite of the Export  command and
  564.        can be used  to import messages  from FidoNet standard .MSG  message
  565.        files to RemoteAccess message boards.
  566.  
  567.              It will by default import messages from the NetmailPath to the
  568.        NetmailBoard if defined. It only  imports netmail messages that  are
  569.        destined to your main address or one  of your Aka's and if the  name
  570.        of the addressee is one  of the users listed in the control  file or
  571.        found in the user file. If a message is for one of  the users listed
  572.        in the control file, MBUTIL will still search the user file (if any)
  573.        for the username, and replace it exactly as it was written there. If
  574.        you use the -User switch, MBUTIL  will NOT import messages addressed
  575.        to users listed in the control file.
  576.  
  577.              If you specify <path> <board>, you can use MBUTIL to Import an
  578.        entire directory of  .MSG format echomail  messages, for example  to
  579.        import messages from  you Dupe path  to a RemoteAccess board.  Don't
  580.        use this to import netmail!
  581.  
  582.      Switches:
  583.  
  584.         -Delete    Delete the .MSG files after they have been imported in
  585.                    they have been imported in the RemoteAccess.
  586.                    This is always done for netmail.
  587.         -Users     Don't import messages to any of the users defined in the
  588.                    control file
  589.  
  590.      Examples:
  591.  
  592.      ; Import netmail
  593.      MBUTIL Import
  594.  
  595.      ; Import all .MSG files in C:\FD\BADECHO to the area "NEWECHO" and
  596.      ; then delete the .MSG files
  597.      MBUTIL Import C:\FD\BADECHO NEWECHO -Delete
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                        10
  612.  
  613.      Post
  614.      ----
  615.  
  616.      Usage:
  617.  
  618.         MBUTIL Post <file> <board> [-From <from>] [-To <to>]
  619.                                    [-Subject <subject>]
  620.  
  621.              The Post command is similar  to the Import command and  can be
  622.        used to create a message with the contents of  a specified file in a
  623.        specified board. The messages will  have the 'Outgoing Echomail' bit
  624.        set, so they will be exported if you post them in an echomail board.
  625.        Post  can't post  files  larger  than  32 KB.  If  <from>,  <to>  or
  626.        <subject> contains spaces, enclose it in double quotes.
  627.  
  628.      Defaults:
  629.  
  630.         -From       First UserName defined in control file
  631.         -To         All
  632.         -Subject    <file>
  633.  
  634.      Example:
  635.  
  636.         MBUTIL Post C:\MBU_REL.TXT 37 -From "Gerard van.der.Land"
  637.                -To "Everyone" -Subject "Message Base Utility 1.10 release"
  638.  
  639.              One special option not listed on  the help screen is the -Test
  640.        switch. If you  use it,  the Post  command will  have the  following
  641.        format:
  642.  
  643.         MBUTIL Post <number> <board> -Test [...]
  644.  
  645.              MBUTIL  will  post  <number> test  messages  in  the specified
  646.        <board>. Those message will NOT be exported. I  used this switch for
  647.        testing purposes and decided to keep in the release version.
  648.  
  649.  
  650.  
  651.      Undelete
  652.      --------
  653.  
  654.      Usage:
  655.  
  656.         MBUTIL Undelete [<board>]
  657.  
  658.              The  Undelete command  can  be used  to  undelete all  deleted
  659.        messages in all boards or <board>.
  660.  
  661.              When messages are deleted, they are  marked as deleted and not
  662.        physically deleted or overwritten, which means that you can Undelete
  663.        all deleted messages, as long as the message base  file haven't been
  664.        packed yet.
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.                                        11
  673.  
  674.      AreasFile Example
  675.      -----------------
  676.  
  677.            This is an example  for an AreasFile. This file,  usually called
  678.      AREAS.BBS, is used by some echomail processors, like Qecho and ZMail.
  679.  
  680.      /--------------------------------------------------------------------\
  681.      Default origin line ! Sysop name
  682.      1   RA_SUPPORT           [net/nodes...]
  683.      2   RA_SUP.028           [net/nodes...]
  684.      3   LOCAL
  685.      \--------------------------------------------------------------------/
  686.  
  687.             In  this example "RA_SUPPORT" would be the same as "#1". As you
  688.      can see, you can  add local areas to  make it easier to  specify those
  689.      boards.
  690.  
  691.  
  692.  
  693.      Purge File Example
  694.      ------------------
  695.  
  696.            This is an example for a Purge File.
  697.  
  698.      /--------------------------------------------------------------------\
  699.      ; MBUTIL 1.10 Purge File
  700.      ;
  701.      ; Example
  702.      ;
  703.      ; 0 Days or 0 Msgs = unlimited
  704.      ;
  705.      ;Board # of Days  # of Msgs  Rcvd             Comment (optional)
  706.      ;----- --------- ----------- ----- --------------------------------
  707.             -Days  21 -Msgs   100       ; Default values
  708.        #001 -Days  14 -Msgs   200       ; Int. RemoteAccess Support Area
  709.        #002 -Days  21 -Msgs    50       ; Nat. RemoteAccess Support Area
  710.        #003 -Days  28 -Msgs   150 -Rcvd ; Local sysop board
  711.      ;
  712.      ; It can also be like this:
  713.      ;
  714.      RA_SUPPORT -Days 15 -Msgs 300       ; RemoteAccess Support Area
  715.      NETMAIL    -Days 14 -Msgs 200 -Rcvd ; This is the NetmailBoard
  716.      LOCAL      -Days 10 -Msgs 75  -Rcvd ; Local board
  717.      \--------------------------------------------------------------------/
  718.  
  719.            You can also create a Purge File with the -Convert switch:
  720.  
  721.            To convert MESSAGES.RA to a text file:
  722.      MBUTIL Purge -File RemoteAccess [...] -Convert PURGE.RA
  723.  
  724.            To convert AREAFILE>FD to a text file:
  725.      MBUTIL Purge -File TosScan [...] -Convert PURGE.TS
  726.  
  727.            To convert your AreasFile to a text file:
  728.      MBUTIL Purge [...] -Convert PURGE.MBU
  729.  
  730.            You can also specify default values:
  731.      MBUTIL Purge -Days 14 -Msgs 50 -Rcvd -Convert PURGE.MBU
  732.  
  733.                                        12
  734.  
  735.      Batch File Example
  736.      ------------------
  737.  
  738.      /--------------------------------------------------------------------\
  739.      :Clean
  740.         rem Do your daily/nightly maintenance here.
  741.  
  742.         rem The Purge command depends on what software you are using.
  743.  
  744.         rem In a RemoteAccess environment you can use:
  745.         CD \RA
  746.         MBUTIL Purge -File RemoteAccess
  747.  
  748.         rem In a FrontDoor+TosScan environment you can use:
  749.         CD \FD
  750.         MBUTIL Purge -File TosScan
  751.  
  752.         rem This works in all environments:
  753.         MBUTIL Purge -File MBUTIL.PUR
  754.  
  755.         rem This command deletes invalid messages, recovers messages in
  756.         rem invalid boards and packs and renumbers the message base by
  757.         rem overwriting the existing message base files
  758.         MBUTIL Pack -Force -Renumber -Delete -Recover
  759.         goto Start
  760.  
  761.      :Unpack
  762.         rem Toss incoming echomail, import netmail, sort unread messages
  763.         rem and create reply chains
  764.         <command to toss incoming echomail>
  765.         MBUTIL Import
  766.         MBUTIL Sort -Pack
  767.         MBUTIL Link -Clean
  768.         goto Start
  769.  
  770.      :Net
  771.         rem Only export NetMail
  772.         MBUTIL Export
  773.         goto Start
  774.  
  775.      :Net&Echo
  776.         rem It is not necessary that there is NetMail that needs to be
  777.         rem exported, but we run Export anyway for the ReTear option.
  778.         rem We are sure that EchoMail needs to be exported.
  779.         rem Just replace the "goto Echo" with "goto Net&Echo"
  780.         MBUTIL Export -ReTear
  781.         <command to scan outgoing echomail>
  782.         goto Start
  783.      \--------------------------------------------------------------------/
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                        13
  795.  
  796.      History/Future
  797.      --------------
  798.  
  799.            Until  now  I  spent  quit  some  hours  writing,   testing  and
  800.      documenting  MBUTIL and  I will  keep on  doing that.  There are  also
  801.      things that  can and will  be done  to make MBUTIL  even a  little bit
  802.      smaller  and faster. There is still  some redundant code that could be
  803.      made more compact  and efficient. MBUTIL is  also using quit a  lot of
  804.      memory at the moment,  which can be made less. Further  I'm working on
  805.      my own echomail processor and a full screen personal mail check.
  806.  
  807.  
  808.  
  809.      Registration
  810.      ------------
  811.  
  812.            As long as you don't register, MBUTIL will remind you of that on
  813.      the screen and in the logfile. MBUTIL  is NOT crippled in any way.  If
  814.      you use this program for a period of  time and you decide you like it,
  815.      you can get a personal RegistrationKey by sending:
  816.  
  817.      * $10US - $99US (Whatever the program is worth to you, may also be an
  818.                       equivalent amount in a freely convertible currency).
  819.  
  820.      * The name you want to have defined after the "RegisteredTo" keyword.
  821.  
  822.      * Any questions, comments, suggestions and bug-reports, and ofcourse
  823.        your FidoNet (or else snail mail) address, to:
  824.  
  825.              Gerard van der Land
  826.              Cannenburg 23
  827.              3772 BH Barneveld
  828.              The Netherlands
  829.  
  830.              FidoNet 2:283/1.5 and 2:283/108.1
  831.  
  832.            Users  in  The Netherlands  can  transfer their  registration to
  833.      PostBank giro-account 5.245.162 in The  Netherlands. For usres outside
  834.      The  Netherlands  there are  a few  other  possibilities to  send your
  835.      registration:
  836.  
  837.      * Cash money in a registered letter.
  838.      * Sending a EuroCheque.
  839.      * International money order.
  840.      * Personal  check.  If you  absolutely want  to  do this,  the minimum
  841.        registration fee is $17US, because of the outrageous conversion cost
  842.        the banks charge when cashing a check.
  843.  
  844.            You will receive your key per crashmail (or snailmail if you are
  845.      not in  FidoNet) as  soon as possible  after I  received the  money or
  846.      money order form or check.
  847.  
  848.      Don't forget to register!
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                        14
  856.  
  857.      Technical Notes
  858.      ---------------
  859.  
  860.      * MBUTIL was written using Turbo C 2.00 and Turbo Assembler 1.01.
  861.      * It writes directly to video RAM or DesqView/DoubleDOS virtual screen
  862.        buffer.
  863.      * It can't be  used while an other  program is also using  the message
  864.        base at  the  same time  (multitasking  environments). It  does  not
  865.        support record locking yet, which might change in the near future.
  866.      * Import and Export are fully zone and point aware.
  867.      * Export creates FTS-0001 rev 12 compatible .MSG files.
  868.      * Import can parse Fido and SEAdog style .MSG dates.
  869.      * Link is based on code written by Folkert Wijnstra.
  870.      * You can  use LZEXE  0.91 by Fabrice  Bellard to  reduce the  size of
  871.        MBUTIL.EXE down to 32 KB.
  872.  
  873.      * TRAFFIC.MBU has the follow format:
  874.  
  875.      struct TRAFFIC.MBU {
  876.         unsigned int  Outbound[200]; /* # of outbound messages per board */
  877.         unsigned char Month, Day, Year, Hour, Minute; /* file created */
  878.         unsigned long TotalCost; /* total netmail cost */
  879.      } Traffic;
  880.  
  881.  
  882.  
  883.      Many Thanks To...
  884.      -----------------
  885.  
  886.        ... Eric Lotgerink, Onno  Hagers, Perry de Ronde, Reinier  de Groot,
  887.      Adrie van  Lith, Folkert Wijnstra,  Gerard Sittrop, Rudi  van Lishout,
  888.      Richard B.  van Dijk,  Willem Blink, John  Veldhuis, Sander  Davidson,
  889.      Sander Eek, Ari Sadarjoen, Peter Smink,  Jan Vroonhof, Arjen Lentz and
  890.      all who I forgot...
  891.  
  892.              All  brand  and product  names  are Copyrighted  (C) material,
  893.        Trademarks <tm>  or Registered  Trademarks (R)  of their  respective
  894.        holders:
  895.  
  896.          BinkleyTerm          Bit Bucket Software
  897.          D'Bridge             Chris Irwin
  898.          DesqView             Quarterdeck Systems
  899.          DoubleDOS            SoftLogic Systems
  900.          FrontDoor, TosScan   Joaquim H. Homrighausen
  901.          IBM                  International Business Machines Corporation
  902.          MBUTIL               Gerard van der Land
  903.          Microsoft, MS-DOS    Microsoft Corporation
  904.          Opus                 Wynn Wagner III
  905.          QuickBBS, Qecho      Ultimate Software Technologies, Inc.
  906.          RemoteAccess         Continental Software, Inc.
  907.          ReTear               Cary Howell
  908.          TSUTIL               Mats Wallin and Joaquim H. Homrighausen
  909.          Turbo C,
  910.          Turbo Assembler      Borland International, Inc.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                                        15
  917.  
  918.      Other Files I Released Recently
  919.      -------------------------------
  920.  
  921.      * FD199CNG.ZIP (84 KB): The FrontDoor 1.99c Norton USER GUIDE database
  922.  
  923.          This archive contains FD199C.NG, which  needs NG.EXE, the resident
  924.          Norton Guides  program. It  enables you  to consult  the FrontDoor
  925.          manual any time you want by pressing a hot key. It uses menus with
  926.          the same conveniently arranged index as FRODO.DOC does.
  927.  
  928.      * FS_100.ZIP (7 KB): Folder sort 1.00
  929.  
  930.          A  program that enables you to  organize your FrontDoor FOLDER.SYS
  931.          by manually moving  the folders  to the positions  where you  want
  932.          them. You can also sort by title, delete folders or duplicate them
  933.          to save time with adding new ones.
  934.  
  935.      * USA_100.ZIP (21 KB): USERS.BBS Statistics Analyzer 1.00
  936.  
  937.          A statistics  program for  RemoteAccess and  QuickBBS 2.xx.  It is
  938.          very  fast,  small, and  fully  configurable. It  can  produce the
  939.          following QuickBest look-alike surveys:
  940.  
  941.          + Best Downloaders (KB)
  942.          + Best Uploaders (KB)
  943.          + Best Downloaders (Times)
  944.          + Best Uploaders (Times)
  945.          + Best Callers
  946.          + Best Message writers
  947.          + Last Callers
  948.          + Best active Areas
  949.          + File/Message Base Report
  950.          + Security Report with up to 7 Security Levels
  951.          + Flag Report with Setting Flags and up to 7 Authorization Flags
  952.  
  953.      The latest version  will always be  requestable as "USA" and  "MBUTIL"
  954.      from:
  955.  
  956.      2:282/220 (V22b), RAccess The Arena,     Stiens Holland
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.      *==================* Pfff... End Of Documentation *==================*
  972.  
  973.  
  974.                                        16
  975.